home *** CD-ROM | disk | FTP | other *** search
/ Chip: 2005 Utilities / CHIP Utilities 2005.7z / CHIP Utilities 2005.iso / docs / tomsrbt / www.toms.net / rb / tomsrtbt.FAQ
Text File  |  2002-05-04  |  12KB  |  363 lines
  1. Contents:
  2.  
  3. 1) tomsrtbt is
  4. 2) Design goals
  5. 3) Contents
  6. 4) GNU/Linux installation
  7. 5) DOS installation
  8. 6) Bootable CD installation
  9. 7) Customizing
  10. 8) Support
  11. 9) Tips
  12. 10) Copyright
  13. 11) ChangeLog
  14. 12) ToDo
  15.  
  16.  
  17. 1) tomsrtbt is
  18.  
  19.     "The most GNU/Linux on one floppy disk"
  20.  
  21.     for:
  22.  
  23.         rescue recovery panic & emergencies
  24.  
  25.         tools to keep in your shirt pockets
  26.  
  27.         whenever you can't use a hard drive
  28.  
  29.     Tomsrtbt stands for:
  30.  
  31. "Tom's floppy which has a root filesystem and is also bootable."
  32.  ___ _                    _  _                        _  _
  33.  
  34.  
  35. 2) Design goals
  36.  
  37.     as much stuff as possible on 1 floppy disk
  38.  
  39.     keep it self contained, build under itself
  40.  
  41.     try to make it behave like a normal system
  42.  
  43.     rescue and recovery functions get priority
  44.  
  45.  
  46. 3) Contents
  47.  
  48. What you have is... AHA152X AHA1542 AIC7XXX BUSLOGIC DAC960 DEC_ELCP(TULIP)
  49. EATA EEXPRESS/PRO/PRO100 EL2 EL3 EXT2 EXT3 FAT FD IDE-CD/DISK/TAPE IMM INITRD
  50. ISO9660 JOLIET LOOP MATH_EMULATION MINIX MSDOS NCR53C8XX NE2000 NFS NTFS
  51. PARPORT PCINE2K PCNET32 PLIP PPA RTL8139 SD SERIAL/_CONSOLE SLIP SMC_ULTRA SR
  52. ST VFAT VID_SELECT VORTEX WD80x3 .exrc 3c589_cs agetty ash badblocks basename
  53. boot.b buildit.s busybox bz2bzImage bzip2 cardmgr cardmgr.pid cat chain.b
  54. chattr chgrp chmod chown chroot clear clone.s cmp common config cp cpio cs
  55. cut date dd dd-lfs debugfs ddate df dhcpcd-- dirname dmesg domainname ds du
  56. dumpe2fs e2fsck echo egrep elvis ex false fdflush fdformat fdisk filesize
  57. find findsuper fmt fstab grep group gunzip gzip halt head hexdump hexedit
  58. host.conf hostname hosts httpd i82365 ifconfig ile init inittab insmod
  59. install.s issue kernel key.lst kill killall killall5 ld ld-linux length
  60. less libc libcom_err libe2p libext2fs libtermcap libuuid lilo lilo.conf ln
  61. loadkmap login ls lsattr lsmod lua luasocket man map md5sum miterm mkdir
  62. mkdosfs mke2fs mkfifo mkfs.minix mknod mkswap more more.help mount mt mtab mv
  63. nc necho network networks nmclan_cs nslookup passwd pax pcmcia_core pcnet_cs
  64. pidof ping poweroff printf profile protocols ps pwd rc.0 rc.S rc.custom
  65. rc.custom.gz rc.pcmcia reboot rescuept reset resolv.conf rm rmdir rmmod route
  66. rsh rshd script sed serial serial_cs services setserial settings.s sh shared
  67. slattach sleep sln sort split stab strings swapoff swapon sync tail tar tcic
  68. tee telnet telnetd termcap test tomshexd tomsrtbt.FAQ touch traceroute true
  69. tune2fs umount undeb-- unpack.s unrpm-- update utmp vi vi.help view watch
  70. wc wget which xargs xirc2ps_cs yecho yes zcat
  71.  
  72.  GNU/Linux package
  73.  
  74. clone.s            duplicate
  75. fdflush            flush floppy cache
  76. fdformat        format floppy 1.7M
  77. install.s        install
  78. settings.s        used by tools
  79. tomsrtbt.FAQ        documentation
  80. tomsrtbt.raw        <== This is it
  81. unpack.s        unpack for rebuild
  82.  
  83.  DOS package
  84.  
  85. initrd.img        installer image
  86. install.bat        install it
  87. loadlin.exe        starts GNU/Linux from DOS
  88. tomsrtbt.FAQ        documentation
  89. zimage            installer kernel
  90.  
  91.  
  92. 4) GNU/Linux installation
  93.  
  94. a) extract the .tar.gz archive
  95. b) Be root
  96. c) Be in the tomsrtbt-<version> directory
  97. d) Have a blank floppy with no bad sectors
  98. e) Do './install.s'
  99.  
  100. The script assumes you have ELF and that your 3.5" 1.44M floppy is on fd0.
  101.  
  102. Virtually all 1.44 drives support 1.722 just fine, but it is possible for
  103. an extended format to break a floppy drive, use tomsrtbt at your own risk.
  104. The install does mknod to make /dev/fd0u1722 if you don't have it already.
  105.  
  106. If you use libc.so.6 / glibc, you might need something like:
  107.  LD_LIBRARY_PATH=/usr/i486-linux-libc5/lib; ./fdformat /dev/fd0u1722
  108.  
  109. Umount any mounted floppies before installing.
  110.  
  111.  
  112. 5) DOS installation
  113.  
  114. a) Pkunzip it
  115.  
  116. b) If you are running Windows-95, do "shutdown and restart in msdos mode".
  117.    You have to be in really-DOS mode.  Not a DOS session under Windows-95.
  118.  
  119. c) CD to the directory you pkunzipped it into.
  120.  
  121. d) "install".
  122.    (This boots a GNU/Linux with prompts to make the diskette.)
  123.  
  124. This is for installing tomsrtbt from a DOS/Windows system.
  125.  
  126. If you have problems, boot with no config.sys or autoexec.bat.
  127.  
  128. Note, this creates the *exact same floppy* as the GNU/Linux installer.
  129.  
  130.  
  131. 6) Bootable CD installation
  132.  
  133. The tomsrtbt-<version>.ElTorito.288.img.bz2 *IS NOT AN ISO IMAGE*.
  134.  
  135. It is a 2.88MB floppy image suitable for *BUILDING* an iso image,
  136. using, say, the -b flag of mkisofs.  See README.eltorito in mkisofs.
  137.  
  138.  
  139. 7) Customizing
  140.  
  141. If you have problems, try doing it under tomsrtbt instead
  142. of on your own system. I test and support it under itself!
  143.  
  144. To customize startup, edit settings.s and rc.custom.gz on the floppy.
  145. Of course you have to "gzip -d" rc.custom.gz to edit it.
  146. Use /dev/fd0u1722 to mount it, /dev/fd0 or /dev/fd0H1440 will not work.
  147. Typical uses: insmod, ifconfig, route, resolv.conf, hosts, mount, etc.
  148.  
  149. For full customization, such as, anything,
  150.  
  151.     (Be logged somewhere with 10+ meg of (non-FAT) filesystem space)
  152.  
  153.     ./unpack.s     # unbuilds it into <name>.unpacked
  154.                 # do what thou wilt
  155.     ./buildit.s    # rebuilds out of 1, 2 directories
  156.  
  157. NOTE:    You need space to DO the customizations. Rc.custom.gz can be
  158.     unpacked into /tmp, edited, gzipped, copied back. Buildit.s
  159.     needs drive space. If you only have FAT, use the loop device.
  160.  
  161. When customizing, edit the settings.s under "1/", not other copies.
  162.  
  163. If you get "not found" errors when running programs, you are using
  164. the wrong libc.  There are many ways to make programs for tomsrtbt:
  165.  
  166.     (1)    You can compile with and link against libc5.
  167.         There are libc5 packages for Debian and RedHat.
  168.  
  169.     (2)    You can do a static link with "-static -s".
  170.  
  171.     (3)    You can put libc.so.6 on tomsrtbt along with your program.
  172.  
  173.     (4)    You can rewrite the program in Lua.
  174.  
  175.     (5) You can rewrite the program in BAL.
  176.  
  177.  
  178. 8) Support
  179.  
  180.     Start at http://www.toms.net/rb/
  181.  
  182.     There is a wikiwiki.  Use the wikiwiki.
  183.  
  184.     There is a searchable archive of the mailing list.
  185.  
  186.     My email is Tom@Toms.NET, but try the archive and wiki first!!!
  187.  
  188.     N.B.: Tomsrtbt mail sent to me becomes part of a public archive.
  189.  
  190.     Tell me what problems you have and what you would like added.
  191.  
  192.     I am not a Unix teacher, questions should be tomsrtbt-specific.
  193.  
  194.         For questions that are NOT tomsrtbt specific, see:
  195.  
  196.             http://linuxdoc.org/
  197.         and
  198.             http://www.geek-girl.com/unix.html
  199.         and
  200.             http://www.ugu.com/        
  201.  
  202.  
  203. 9) Tips
  204.  
  205. 'Login as root' means the USER ID is "root"!  I thought it was obvious...
  206.  
  207. Use "man command" if a command acts strangely
  208.  
  209. "wget" does ftp and http
  210.  
  211. / is full. /usr is full. /tmp has room.
  212.  
  213. tar and cpio are 'pax' and differ from gnu-tar and gnu-cpio.
  214.  
  215. Instead of:
  216.         tar -xvzf /dev/st0
  217. Use this:
  218.         gzip -d < /dev/st0 | tar -xvf -
  219.  
  220. Pipe through dd-lfs for files over 2 gig
  221.  
  222. To run glibc programs from your hard drive you can use something like:
  223.  
  224.     "chroot <mounted glibc filesystem> <program>"
  225.  i.e.,
  226.     chroot /mnt /bin/bash
  227.  
  228. LILO. The lilo version run *must match* the boot.b
  229. it uses.  A common solution is to do something like:
  230.  
  231.     mount /dev/hda8 /mnt
  232.     mount /dev/hda1 /mnt/boot
  233.     chroot /mnt /sbin/lilo
  234.  
  235. Mount the floppy if you need a boot.b and zImage; chain.b is in /etc.
  236.  
  237. Command history is via ile from /bin/login, see "man ile" and /bin/login.
  238.  
  239. If something is missing, look in the add-ons.
  240.  
  241. For pcmcia other than common NICs, go to the add-ons.
  242.  
  243. wc login man shutdown ps split tee grep & head are scripts or luas.
  244.  
  245. edit rc.custom.gz to enable rshd or dialin or 'telnetd'.
  246.  
  247. For the fake telnetd, use 'mode character' and 'set binary'
  248.  
  249. If you need to not be root, use a suid shell.  Login won't do it.
  250.  
  251. Instead of rdev use lilo, for examples see the mailing list archive.
  252.  
  253. To copy between 2 tomsrtbt systems, use something like:
  254.  
  255.  find <path> | cpio -o | rsh <system> cd <path> ";" cpio -iumd
  256.  
  257. I do not use "Red Hat", please do not ask me questions about it.  They are
  258. an 800 million dollar company for ?sake.  Surely they have a phone number?
  259.  
  260. Their address of record is:
  261.  
  262.     RedHat
  263.     2600 Meridian Parkway
  264.     Durham, NC 27713
  265.  
  266. Send them a letter about your problem...  Ditto "Mandrake", "SuSE", "DebIan"...
  267.  
  268. At this point, tomsrtbt requires about 8meg to boot, even more to unpack.
  269.  
  270. It is not hard to replace the 2.2.x kernel with a newer series, just unpack;
  271. make sure the kernel you are substituting supports floppies, ramdisks, and
  272. minix; and rebuild.  Edit settings.s for the new kernel name.
  273.  
  274. Instead of:
  275.     A=`expr $B \* 2`
  276.     C=$D+$E
  277. use:
  278.     A=`lua -e 'print('$B' * 2)'`
  279.     C=`lua -e 'print('$D'+'$E')'`
  280.  
  281.  
  282. 10) Copyright
  283.  
  284. ***************************************************************************
  285. * See http://www.toms.net/rb/license.html before redistributing tomsrtbt! *
  286. ***************************************************************************
  287.  
  288.  
  289. 11) ChangeLog
  290.  
  291. 2.0.7 rc.pcmcia cleanup, more devices, juggle some stuff
  292. 2.0.10 set dhcp flags broadcast bit
  293. 2.0.12 newer busybox with bugfixes,
  294.     replace klogd/syslogd/logger with traceroute and rmmod,
  295. 2.0.15 current chattr and lsattr
  296. 2.0.17 added dd-lfs for large file support.  Poor mans LFS.
  297. 2.0.20 added tune2fs and fancy busybox ping, minor doc fixes
  298. 2.0.21 added badblocks
  299. 2.0.23 various documentation fixes
  300. 2.0.24 make elvis & fmt smaller
  301. 2.0.28 make lilo docs smaller
  302. 2.0.29 fix a dos installer bug
  303. 2.0.30 remove sgi/aix/sun/bsd support from fdisk
  304. 2.0.32 add PARPORT, PLIP, PPA, and IMM
  305. 2.0.38 add SLIP, slattach, .exrc.  Trim pcmcia module size
  306. 2.0.47 add httpd, watch
  307. 2.0.48 replace sysvinit with busybox init, halt, reboot, poweroff
  308. 2.0.51 replace busybox kill, killall, killall5 with asmutils, add pidof
  309. 2.0.52 add userspace memtest
  310. 2.0.54 remove userspace memtest, still looking for the right thing...
  311. 2.0.55 recompile ash, newer luasocket, no lua regex and md5/crypt
  312. 2.0.79 rework busybox init to support HUP adding inittab entries,
  313.     modify bz2bzImage progress indications
  314. 2.0.81 add rtl8139 and ne2k-pci support
  315. 2.0.85 add dumpe2fs and debugfs
  316. 2.0.86 put lsattr and chattr into e2fsprogs crunchbox
  317. 2.0.87 rebuild pcmcia for good luck
  318. 2.0.89 try replacing the real 'nc' with busybox 'nc' (netcat)
  319.     try to fix a bug in init.c
  320. 2.0.98 patch busybox nc for SO_REUSEADDR, try replacing again.
  321.     more tweaking of busybox init.c
  322.     *** Warning:  Some add-on modules may now break *** If you use add-ons:
  323.     *** See: http://not.toms.net/twiki/bin/view/Tomsrtbt/BrokenModules
  324. 2.0.102    mess with init
  325.  
  326. 12) ToDo
  327.  
  328. There is a lot of stuff now that is amenable to Lua.
  329. Also, the new Luas need to be cleaned up a lot.
  330. As well as, the lua manpage needs more work.
  331.  
  332. Com     TypEffPriDes
  333. ash      b  h  4 echo won't allow both -e AND -n
  334. ash      b  h  6 bizarre 'read' bug
  335. ash      b  l  6 manpage omits $$, $_, etc.
  336. ash      b  h  7 fix or doc builtin "test" bug
  337. deb      e  l  5 enhance undeb, blocking, toc, more
  338. dhcpd    e  h  2 fix more
  339. doc      b  l  5 update manpage for (gnucpio or busybox)mt
  340. doc      e  h  5 fix all manpages
  341. expr     e  m  3 make an expr in lua
  342. file del e  m  5 look into file recovery program
  343. floppy   e  h  8 mess with higher formats like 1840?
  344. hexedit  e  m  4 wrapper for diskediting
  345. libc     e  h  9 convert to glibc6 2.1.3
  346. more     b  h  2 fix console bug, smooth scroll backwards
  347. mount    e  l  3 update man pages
  348. mount    b  h  6 -O2 breaks '-t nfs', -O1 works, why?
  349. pax      e  h  3 enhance to do gnu-tar and gnu-cpio opts
  350. smbfs    e  m  7 check size
  351. sort     e  m  4 remove or replace with an lua
  352. startup  e  h  2 test initrd, root.gz->minixfs ideas
  353. telnetd  e  m  5 improve
  354. termcap  e  l  4 man page w/ setterm fake shortcuts i.e. ^V^[[?5h
  355. kernel   e  m  4 consider sunrpc/nfs for removal to addons - big
  356. build    t  m  4 test gzip ability of buildit.s
  357. kernel   e  l  3 compare kernel .o sizes
  358. libc     e  h  5 test libraryopt
  359. tomshexd e  l  2 replace tomshexd
  360. org      e  m  2 test effect of grouping on compression
  361. reiser   e  h  7 patch fix reiser to allow addition
  362.  
  363.